A^M^i'^^ 



fmn^ 



gITERHAL REFERENCE SI>iCIFICATION 
for 
SES NOTOROLA 68000 UTILITIES 



Approvtds ._ ., 



DISCIAIH€RS 

Tt^^ls document Is an Interr^al i^orklnci paper onl^. It (s 
sufojf^t to nh9n%%* tn4. dots not nteassirHy rtprcstnt any 
o^fjcitl inttnt on tht ptrt of CDC. 



CGHPAMY PRIVATE 



COC - SOFTWARE EH6INEERI^iG SERVICES 
EPS for MOTOI^OLA 68000 UTILITIES 



05/10/84 



REVISION DEFINITION SHEET 



•- — "♦•- 
V I 



DATi 



OESCkIPTIOH 



09/30/82 



05/10/84 



Orialr^sl ERS 

Nt« prois«durt (ftscr I pt Ions tddtd for 

GENSS68K# BLDmmKf PURSYHeSKj snd 

T??AN0IIIB« Additional caps^Hltles for 

local ■ syspbois hM'^e h€«n m^dibtl to 
l?£F0l?H68K, 



c 1982 

Control Data Corporation 
All RIcihts P.t.sBr^fi-<! 



COMPANY PPIVATF 



CDC ~ SOFTWARE EN€INeERING SERVICES 
EPS for NOTOROLA 68000 UTILITIES 
1.0 PREFACE 



1-1 



05/10/84 



1-0 £E££A££ 



la liUQfiyOiiii 



The 

he I p 

TRAN68 
S i fiJu ! i 
SIH68K 
SO M ee 

the m 
REFORH 
in H-P 

rtcord 

Bio^ie 

put 
d ^ H u a 

^ «J S f n* *'- 
TFA^'DT 

p ^c^ *»?^ 

memory 
the SE 



Hotor 

tht s 

tor o 

r ufjs 
ti on 

680C0 
66K f 
r 1 1 o 

S :• G 

PK but 

n fn 
SVfP^ I 
ler ^r 
LIB tr 
fi M 
• The 
S pro€ 



ol a 

oft 
rat 
r 

th 
of 
■iss 

€«f 

€llt 

gNG 

lis 

ols 

t i 
Oil 

t 

MC 

ess 



6 

Hi 
«S 

m 
e 

m 
em 
er 
ib 
S6 

a 

Jt 

foi 

al 

I a 

o 

68 

or 



8000 
ft 

abs 
yttii 

HC6 
cdul 
bit r 
mats 
1 1 
8K 

n B.b 
ct 

es f 
I til 
tes 

'si V V 



yt i M 

devei 
olutt 
r5«? th 
8000 

«S PS 

ind 
a 1150 
object 
1 n e r s 
solute 
f 1 1« o 
enarat 
e iiotly 
an obj 

Ut i 11 1 



1 1 es 

pwtn 
r eco 

it 

Sliiu 
■n € r a 

dul e 

t -8 
t«s 

meffi 
r ol^ 
td !b 
las 
ect 

I o a 
I «s 



are a 
t proc 

r ds f 
Cin re 
I ator • 



ted 
t® 
in 

Mt 

ory 

ject 



a 
CDC 

and 

I WB 

li 



y t he 
on ill 
file or 

d « d f 
run Bs 



CO 1 1 ec 

ess 
r yst 

id Mot 

BIND 

tha €¥ 

ob jec 
/or H 

P I in 

g 6 p o d 
br tr y. 
CY8IL 
t li f f I 
b j e c 
r t 
st anci- 



tlon 

n tbi 

by 
orol a 

68K u 
BIL-CH 
odul 8 
t text 
~P lo 
kar s 
u 1 e t 
PURS 

les us 
t llbr 

I box 

alone 



f t 
CY 

tba 
«$• 
I i i 

oom 
fro 
to 

Oil 

ywbo 

bat 

YH68 

tbe 

0cl a 

ary 

to I 

C0!?1?S 



00 Is to 
BER 170. 

HC68000 
records « 

takf t 
pilar or 
ffl tb8fP» 
s !i?ody|e 

symfco Is 
Is file. 

can foe 
K ?l e I a t s 

HC68C0C 
s Inpyt. 

Into a 
otc^ Into 
0n<is V I fi 



1 . ?• A££iI£iIi£^fiO£ili£iIS 



The following Is a !lst of docyments that either are 

r«f«ri»no«0 In this soec I ^1 cit I on or 9Te rf'com'^tn ded to tld in 
understand Ino this spec I fi cat i on. 



1) SFS User's Handbook CARH1833) 

2) SFS Objtot Code Utilities (ARH2922) 

3) S6S meSCQO Absolute Linktr CARH4895) 



CrHPAWy PRIVATF 



CDC ~ SOFTWARE ENGINEERING SERVICES 

©5/10/84 
BUS for HOTORCIA 68000 UTILITIES 

2*Q NOTOROIA feSCCC UTILITIES COWMAMOS 



2 * H0IQSQi4.-^Sfi§S-yil.LIII£S«£0fiM4ill5 



The Hotorolt 68000 Utilities use System Control Inngu^ge 
(SCL) syntfx is the p«riiieter lnt«rf8C«« In th« descriptions 
thi*t follOM* optlonti parameters are enclosed In brackets* 
All ptrifPfttrs of typB •ntiit' c«n htvf a isifxi usu??? lerigth of 33 
€tfrtctars# except for pariiptters dtsignstsd ts file nanes 
(NOS flf^ ntffifts Cinrsot txctad 7 ehprscttrs In length). 



2 • 1 I£liMI-r«££M££iI£-.I«S££CBfil 



TRAN68K generates a file of ?1ctoroia S records frorrs the 
outpyt files of the HC68000 Absolute Linker. 



trifsfSk t^dr«<f i I ensffl€>. 
sr ec*<f I lenafie> 
Cun-<ys«rnt»t> 1 



Heir * h s 

Nsfsie of the header file frojn the Absolute Linker* 
T^'^ file nnwB hus tha for??? mxxxHDR froJR the linker 
>iher% xxxx Is the nafrie seed given by thg linker. 
This file crontsins inforipatlon »bout the other files 
needed to create the S records. 

sr*»c J s t 

Msni€ of file to receive the S reeort^s. 



un s 



User number of cttaiog to search for hdr file B/n.4 the 
other files needed. The default is the current user. 
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z*Q miQmik fescco utilities cohhanos 

2.1 TfiAN68K - GENERATE S RECORDS 



Exif??p| # 



ses. tr-an68l< seg.?i?.hdr srecfll 
l?fVEI?T* END TRAHdSK 



This ^KasBpl© shoMS TRAH68K creitlog sr«ef II fron' fllas tfist 
BTB specified b:v segmhdr In the current user's catalog. 
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2,0 HOTOROIA 68000 UTILITIES Cn^MAt^JDS 

i,Z SIH68K - RUN THE HOTOROLA fBCOO SIMULATOR 



2.2 uMm^z..gm^m^BuimDLiJimm^iimLkiQK 

SinmK runs the HC68000 siiiylator and acquires the •$' ' 
r«0ord flit tf^it his the il?soult« oitwor^ iipsge* Cosi^asinds for I 
tilt sipulftor can b« entered at the terminal or entered 
tt^roygh » conRHJificI file. The output is e I thur yr i tttn at the 
terffilnsl or to a specified file* 

N0TE3 Oocuptntat I Of) for th» simulator tnd its ccinmincfs irt 
In th€ ^68000 Sipuiitor Ref«rsnce Htnytlf Hfe8K0SIH{D21 froi? 
.Motorola* 

siw68k srt e«<f I l€n*JT«> 
Ccf «<f i ien*»'rp>3 
Coytput«<f I lenanre>1 
Cun"<ysarneme>3 



sree I s s 

Naipe of file that contains •$• records* the absolute 
peffiory iitapt to bt loaded b> the, simulator. 

cf J 

Nape of file tisat contains cowniands to fee executed 
i lifff di tt«l y upon tctlvstion of ttt simy«itor« The 
coiisnitncf file consists of one or !T5crt v^lid slmuli^tor 

co*i5{rands« If you do not specify ttis partmater^ 
$IH68K. takes commands frofP the input file assigned to 
your tf rroi naf • 

output or i 

Nt?!!t of file to receive the output from the 
si)T!yiator. If not specified, SIH68K writes to 
OUTPUT. 



un s 



User nuTsber of catalog to search for the srsc and cf 

files. If not specif I ad# thf dtftult Is the current 
user. 
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2.0 HOTOROIA 68C0C UTILITIES COHHANDS 

2.2 SIH68K - mn THE HOTOROiA 68000 SIMULATOR 



EKiispl f s 



ses«siR?68k memory 

l^tt^* H68K 8ATCH SIHULATION 



82/07/30 16,44*53, **=«^** 



This sxainple shows SIIi68K used to sliriulitfi tf^t profrnwi on 
file m«mory« Any eor^fi^end mey fo« tnttrad tfttr tits ? 



ses«sl»68k cyOOlsr cf*ccipffiand o=llst 
RI¥ERT» END SI^68K 



TM s ©xiflRPle shoNS SIM68K ustcl viith t ^ommonti flit «nd an 
oytpyt fil«« Ttie siwylator Is going to load cyOQlsr Into 
iiie?!?or^ ind then «x<»cute th« ecr^wands en th« file eonis?ind# 
Oytpyt fro?! the siwulttof *» H I foe on tf^e fil<* list. 
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2.0 MOTCR0iA 68000 UTILITIES COWHANOS 
2*3 6IND68K - 8IN0 HC68CCiO MODULES 



2.3 Mil}Mi<..«-llMO^i^iififiM-liQiiyLi^ 
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*» of this eommtnd is to crtttt a single bound 
om the sptclfitil eowpor^ent ohjeet or iotrf mo 
ectlons of tlia old modylts tre eoeibined I 
<l« stctiofif dtts sections witN identical tttr 
ed Into a single section and the blndlno se 
ned tnd f*»orgtnlztd for wlnlwyrr; radundsncy* 
nitlons ^^iiieh are referenced frofi one or 
iiodujfts are d®l«»tc<l unless they htva haen expl 
on this cofi?!sand or they have been pr ev 



load 
ily I is# 
nto 9 
I b u t f s 
ct I ons 
Entry 

incr f 
Id t If 
ious l.y 



bind68l< f|le*llst of <f M elf us«r nima3> 
nspe*<fiicdul e nape> 

rffiO(lyle-llst or r»nae of <Pocly|€ nnme>l 
£r€taln*Mst of <eMttrn8lly declared procedura 

nsme>1 
CofPlt^llst of <ext8rnany declared procedure 

Is ttrt Ing.pr ocedur €«<exter ni» H y decltred procedure 

ni.iiia>l 
uPon = <f I I eCf user name ■1> 
Cbts«=<fl fei:>usernsfr-8 3>3 
riockC^f I I ell 
CGytPut*<f I f B>1 



flit I f I I ihrary J i lb « 

This ptramettr mny b% coded as e 
of subllsts. Etch elfifs^nt of tht 
single n-BM^f refer I ng to the 
alrtiidy tssipned to the job or 
user's csttlogj or tha attffi-ent I 
last sub-eleiT'ent in the sub I 1st Is 
whose Cittloo the files {or llbrs 
by the other sub-e I ejnents wny 
eKfPple at the end should help cle 



!!5y 1 1 1 

vf lue 
nBwe 
I n t 
s s s 

a us 
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be 
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value 
list 

of 

be € 
ubi Is 
er na 
r e f e 
found 
is UP 



d list 

I s e 
a « f 1 I e 
y r r e n t 

t ,♦ the 
rr-e I n 
red to 
« An 



name I n J 

This pisir iff^eter specifies the' ?^ody|e n^me, to hp> 
?%ssocieted nltb the created module. 
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2*0 HOTOROIA 68000 UTIIITIES COWHANDS 
2,3 8IN068K - BIMO HCfcSCOCI HODULES 



?POdul t 



fflody I es 



m t 



r « t s I n 



Tliis partsiet^r specifies tt^€ i^odulas or pccfyJe 
sul^ranges frop filss or llfortrles tl^tt are tc fee 
coffiponer^ts of the created ipcdyle* If not 

sp€clfle<ff all tli« flnodyies tsn tht speclfltrf tilts 
fnd libraries ylif bt us€d «s eonipontnts* 



r J 

This parameter specifies the external If 

Miias rtfertnctd b,v 

ffiodule thit art to fo« 

i5odule« Procedures 

previously r^asd not 

p 1 r t tts e t e r • 



I* eoppcnent of fh' 
retiined In tht 
that have b&en 

be r€sptcl f I tc^ 



d e c I i r a d 

cf t tt tcf 

c r e « t f d 

reta i ned 

n thj-s 



offii t 



t 

This para:?!5eter specifies the externally declared 
ntp-es In th% component modyles %^hose olefin it ions 
ir« to bs r«inove-d froii? tht output !!iodule.» 



start I ng^procedure ? sp J 

This p«r«ip©ter specifies thf txterntll^' dfclar'td 
name of the proctdure tt which execution Is to 
begin* Omission causes last trtnsftr s.yf!?feol 
encountered to be used* The sttrting procedure Is 
§iM^y% r«tslned In the new isoriylt* 



upon 



up 



hist 



This ptriPeter specifies the file tc cont?»in the 
created r^cdyle and the user ntP® In whcst ctttlop 
the file Is to be plfceci* 

t hsstlife 1 fo! ! 

This parameter specifies a file of object cede 
iiiodules that the upon file *^i M he sdde<^« SES 
procedure GOF will he called if the keys b or fo«»se 
or just a file name Is speciriecf* GDI wilt be 
called if the keys htstllh or hi tre specified* 
GOF ^nd GOL use the upon file ts input end the 
hase Is rewritten Mith the created module ^s thf^ 
last fiidodule* 
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2.0 J10T0RCL4 68000 UTILITIES COf'^^ANDS 

2.3 BiNDfceK - BIND HC68000 NODUl^S 



ioek * no lock * 

these ptramaters deterffiloe whether the librarf 
upclits process is Irittrl ccif «d «i«iiist sluulttnecus 
upcfistts* Coding i filentiit f'or the lock ptra^#t«r 
dtttrf^lnes th% n^me of t^t Intsrlocl* flit* 
Interlocking is the default action when the upon 
file belns yocltted in «noth«r ustr»s oitfloo. 

output I out s 

This P»rf«?«et®f sp«clfits tha filt ntm** to which an 
object t^Bp of the newly crettud spodule Is to be 

HfltttO. 



Bxnmp I e 

If you type In the folloi^inoi 



ses* blnci68k f«Cmyl ib*stryot#{slnffCosinf'#tfn#»» 
ftnlib)! tr i g,^f unct I ons sp^stt-rt up=hoynd 



The flies isyllb ind struct ir« tlther slrttdy Iocs! or 
pulltd from your catalog. The fHes sine* coslntf nnd tmn 
tra in the ftnllb cattloi or loc^fl. Ths ntroe of the nsM 
module will bs tr I g_f unct I ons and tht nfi^i^ modu\€ hIH hs on 
th« fM« hound. 



CO^^PANY P^lVhlf 



CDC - SOFTWARE eH€INEiRING SERVICES 
ERS for HOTOROLi^ 68000 UTILITItS 



2-8 
05/10/64 



un : 



User nuniber of catalog to searc>^ for Input fll» 
The default is the current us^r • 



2,0 HOTOROIA 6800C UTILITIiS COnHkHDS 

2.% REF0RH68K - RE-FORHAT MODULI TO H-P OBJECT TEXT FGRHAT 



Z * 4 E££fiEI!§Si<-.r-.E£r£aSM4I«iQ.fiyL£-.Ifl-H=£«.Dii£CI«I.£II«£S.ilfiI 



PgFOPf^feSK tikes 1 rulocgtafole isodule In ths CDC object i 

t@Mt foripst ind converts it to the H-P fofPtt. Qpfi CDC I 

file with relocatable object text Is ref orfratted into tMO I 

files which confor?!? to the H-P forwfttt 1) t fill* contalr^ino I 

relocstihl€ ofeject codt (kno**n in the H-p Norld as t * 

"rtloe** t¥P0 fll«)f ifid/or 2) s file containing the local I 

syfrhols for each it-cdule <known to tht H-P ts «n "asiib.syp** * 

t¥P# ^lle). One of hothe of these flits can he generattd* I 

fls psads dictate* Tht re-f ornttttd ffiodyltlsJ can then bt * 

doi^nloadad for use on an H-P 64000 workstation* This I 

proctdur© ^111 work on sn input file pith mort than one * 

mo<|yl#. Each module §tts's stptrite record on each of the I 

oytpyt flits* \ 

rtforfflfe8k inpy t«<f I ltntiie> 

Coytpyt«<f i I tnaffit>1 I 

tsyfibols»<f I l#na?P^.>1 ? 
Cun*<yser narP€>3 
ys«rlcf*<H-P userld> 



Input « I t 

Name of flit containing the inodule cr n?odyles to 
fo« r t-f oriTiitttd* 

output I o J \ 

Haws of file to recslve re~f orisstted module or * 

podyles* If you don't code this p«»r «fP€ter.> th^< I 

vslyt of the prof! Is vtrltblt 'hprfloc' mill be I 

usfd (if It exists in your "profile" file), i 

I 

symbols • sym s I 

Nsine of f I I -e to rective rf^f orirrstted local symbols I 

for B podyls or modylas* If you don't code this I 

paraffleter? the value of the profile variable \ 

•hp locsyr?!' will h€ used Cif It sxlsts in your » 

•♦prof i le" f i le), ! 



ysarid J uid J 

A string cf uo to 6 characters that is the user id 

frosp tn H-P develoomtnt stttlon. 
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£•0 MOTOROLA 68000 UTILITIES COHMANDS 

2.4 REF0RH68K - RE-FORHAT HOOULE TO H-P OBJECT TEXT ?=OR^AT 



Eximp t f 



y i d-'hpf I I e 
REVERT, END REF0RH68K C YREL->HPPEL f HPL SYH 



Tli» flit cyrel Is i filt of COC objeet ttict in tl^e 

cttflog cvlTO. Th# ofcjtet ti)ft In H-P foniat will b€ on a 

flit nsped tiprsl. TN« locsl sytpfeols wilt be on a file 

named hpisymm The ystr Id hpflje is ptrt of tht fi!« 
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2«0 HOTOROLA 68000 UTILITIES COHHANDS 

2«5 GfcNGSeeK - GENERATE AN H~P LINKER SYHSOLS FILE 



2 • 5 M.iSMiJ<^=«Bf Mililf .^lM.M=£«LlM!<II-lI,iB DiS.£li£ 



€aNGS66K scctPts m input tht »»db§** file cytfsut froffl 
LINK68K (th«? debyg kty^orcf must bt sptcifitd on the can to 
LINK68K ©r fit) "dtip^fiit wHI fo« g€0€rtt«d)« ' Th« file Is 
r ef or iiiatted Into an H'-P Linker S.y:fiibois File lalso referred 
to In tfi« H~P s?gnufls as f *'iink_s:yp" type tils, or '^Fne 
Type 13'*)* Ttie H-P forpitteif file ctn than be downrcacltcf 
for us« on «n H~P 64000 *iorkstat I on, 

P**ncis68k lnpyt«<f I lsnii!?e> 

Coytpyta<f I l€n«i.pe>3 
Cyserld«<H~P us€fld>1 

Cyn«<usernf:me>3 



inpyt ? I I 

CreqyIrtdl nisit of tlit linker s:^f^bois flls output 
from LINK68K* The fill? ntme tss the forri^ 

•xxkkDBG'# iitiere 5ckx Is thm nnm^ s««d ustd by 
tINK68K. 

oytput I o J 

(option®!) nime of i flit to rectlvt tte H-P 
formatted Linker Symbols File* If not specified^ 
GFNGS68K v^rlt«s to f locul file rtm^d «HPGSYH». 

user Id ? uld : 

(optlonan 1-6 character H-P user ID* This Is the 

sifpe ID entered on tti» HP6^000 In r?»sc>onse to tha 
ustrid proiupt* If deftult«d.# th#n tlit current H-P 
yserld ij I i I te used when tte file is used on the 
H^P vior kstat Ion. 



un J 



toptiontl) user ny?fsher of c«*teloa to setrch for 
the Input file. If not specified* the default Is 
the current yser* 
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2*0 HOTOROIA 68000 UTIIITIES COHMANOS 

2*5 GENGS68K - GENERATE AN H-P LINKER SYHBOIS. FILE 



f K §mp t t 



sts«iengs68H l«.Jyr^.edbg yid«hpid 



In ttiis «xafflple.> the file naied junadbg Is a file of 

linker Ci««« global) symbols* the H-P ^ormptttd linker 
symbols win bt on a file namtd t^pos^irs tn<^ t^t ys«r id 
•hplcf* Is recorded in thst flit. 
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1*0 HOTORCIA 68000 UTILITIES COP^^ANDS 
2,6 BlOHIfeSK - BUILO m^VRY Tf^AGh 



2 * 6 iLfi!!l^^l<.=-IUlLll-I£l!iai«IM£I 



6L0HI68K ififierttas ar^ sfesolute iiodulf from th« output 
fil^s of th« HC68000 Absolut® linHBr* Ttif fMt spteifitd 
by the hdr psraineter Is acquired b^ the procedyrs If It Is 
not local. 

bldpi68l< niiiit*<wodu I a fiaist> 
lidr-<f I I enaiie> 
£ ou t p u t * < f I Ten iP i > 1 

Cun*<userns?i8>1 



Ipput I I J 

T*^ls partmtter sptcifles t*ie module nif^e to be 
sssoclattd Mltli- th« created ibsolytt podult. 

Mr i h i 

Hiwit cf ttie header file from tl^« Absolute Llnktr. 
TH« file fiama fits ths torn? xxxxHOR fro?!? th^ linker 
sellers XXX Is the nsme seed given by the linker* 
This flit contslns Informstlon sfooyt the other 
files nesdad to create thf nhsolutt irsodyle, 

output lot 

Nair-e of file to receive thf nBu tbsolyte module. 
If you don't eodt this psrimeter* the default file 
r\Bm€ Is HI8HO0* 



un ? 



Us«r nuphtr of csfstalop to s@ar€h for hdr file and 
the othtr files needed. Tht dtfsult Is the 
current user. 
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Z»Q MOTOROLA 68CI0C UTILITIES COHHAMOS 
2.6 BIDHI68K « BUIiO HEHORY IHAGE 



Ek imp I g 



ses .bl dm 168k tbs^podylt segitlidr nmuwt}4 
REVEST. ^m 8iDHI68K 



This exaiPple sboi^s 0lDHI6eK ereitlnc nn »l?solut« wiodule 

t)n^e(l tbs^fpodu I e f r cm files tliit «re soecl^'led by segphdr 

In the €yrr«nt user*s citilog. Th« modylt «j|| fct op tti« 
file neviffiod* 
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E.O MOTOROLA 68000 UTILITIES COI^WAHDS 
2.7 PyRSYH68K - PURGE SYMBOL TABLES 



2 . T £llElII!^S!<»r-.£UEi£-lIfiSfiL«IiIL£l 



PyRSYM68K r^iiovts dchug symbol tal^its* pentr«t#d • by 
CYBIL/CH or tti® HC68II00 tssafpfeltff frosf pcdulfs on ofcjfct 
files or. object ilbrarles* The Input files are acquired bf 
tbf pfoctdura tnd tt^e oytpyt files ir« rs^ritten is 

fea» 



pernianent 

sped f I ed 



f i les» 

for both 



The sifpe number 



f i Its must 



the input ind output p«r«ffittefs« 



pyrs¥»68k lnput's<nst of flleni«ies> 
output«<list of fileoifl?e> 
run«<us«rn»ipe> 3 



Input I I s 

Nuiise of file or list ©f filts contflnins cfsbug 
symbol tables* Tbese files are ac^suired if tbey 
«r« not locil. Tbtse files ctn be object files or 
ob Ject I i brtr i «s • 

outout I i 

Hnme of file or list of files tbtt do not contiin 

clebu^ sywbol t«bles Nben this procedure is 
finished* AH tbese files «re rewritten Into tbe 
catalog of the user nufsber specified* If tbe 
input file is tn objact flla» the output file will 
be in object file tnd tbe stJie holds true for 
ob Ject I i brar ies* 



un I 



User number of cstalop to searcb ^or input ^iles 
end wbere to rewrite tbe output files* Tbe 
default is tbe current user* 
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2*0 MOTOPOIA 6800C UTILITIES COHHAHOS 
2,7 PyRSYH68K - PURGE SYMBOL TABLES 



EximpI e 



ses»pyrs:fffl68N lexse Ponitor) CctMs mntr) 
REVERT^ END Pm.SYHbBK 



Ttiis exsBEple sIicms PURSYN68K refflovlPi defeug svnibl tfbi«c 
froff KPocfytfS ont ths filt i?m€€ unci putting tlie module 
♦without debug syipbol ttfolts on thf file etx«» The sawa 
done ^Ith monitor and s?iitr« 



is 
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2*0 HOTORQIA 68000 UTILITIES COHMAMOS 
2*8 TRANDILI8 - TRAHSLATE 01 II8RARIES 



2.8 I£M0iiIl«=-IE4iaL4II.IlI«LiifiiiiIl 



TRAHDIilS picks objtct podules on object files or object 
libraries Into byte oriented data Ji^applngs so the nein file 
or tlbrtr^ ctn be clownlot<led to tfit 01 hon* Ihm object 
fiodults will ippesr to b«»ve bmen gen«rttfcf by CYBIL on thf 
C18C. Tb# pui?b«r of input fn<*s spfclfitri n?ust to« tbe sar??© 
as tbe number of oytpyt fifes spaclflecf. 

trini^inb lnput»<nst of f i lftn«ip«s> 
outpyt-<Hst of fiiena?i!e> 
Cun=<«sern«ffle>3 
C f I I e J 1 1 b 1 



Input I i s 

NaJi« of file or list of ^'ll^s to fei? trtnslttecf* 
Tb«s« fn«s Mre: icqylr«<l If tbt^ mr not lo€«l« 

output I t 

H$mB of file or list of files tbtt bsvs betn 
tr«nslit©d wh«n tbis oroeedur*? Is flnlsbecf. All 
these files Bxe reMrltten into tbe catalog of tbe 

us«r number specified* 

un J 

Ustr number of catalog to searcb for Input files 
i»nd mhBre to rewrite tbf output files. Tba 
default is the current user. 

f i fe ? f J I ib ? I I 

Tbis key**or<l specifies tbe for»f?tt of the cutout 
flies. If vou code Mlb'* the i poduie directory 
i^nd tn entry point directory tre Includeci In tbe 
output files. If you don't code sitber keyword* 
then the default is •f|le». 
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2.0 f^OTGPClA 68C0C UTILITIES COMMANDS 
a. 5 TRANPILIB - TftAMSLATe 01 lIBRARieS 



E K f m p I f 



ses.trandiHb Cobjfill ofejMbll Cotjjfna objfHSI 
REVERT. £H0 T^AHOIilB 



This exaiple shows TRANDILIB picking fill tht object 
ipodyles on ttis otijtet flit* objf i II «od t^# object llbrery* 
objtiblf Into ptckttJ ^bjact ^ilts ofojf I 12 nn^ obJfH3.- If 
you had specified lib or I Instead of flis* objfll2 sricl 
otejfll3 Hoylcf hivt batn packed ofejfct !itiri»rlfs 
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3*0 IEIQfi«M£5ii£Ea 



Thf* to Warning litssagts art oytpyt at tht t^rir?! net! on of 
cofi-ffancfs. All errors cause comipand to sbcrtt 



20001 HEADER FILE fU^^nmm^i IS SAO 

SEVERITYJ Error 

MEANING! filt^nitw*^ dots not huve the hetdtr 
flit f oriPtt 

20002 SeSMENT FILE fii€_ni!«e NOT FOUND 

SEV€R.ITYi trror 

MEANINGi Stif explsnstory 

20003 ACQUIRE ERROR fll«_oaPt 

SEVERITYl Error 

BEAMING? Intarnal trror trying to acquire 

20CC4 USiR ID long.user.Id IS TOO LONG* ND« 
short^ustr^f d 

SEVEI^ITYJ Infor?!)ationtl 
MEAHINGt S«lf txpltnstory 

2CO05 SYMBOL iong.syiT^bol HAS 8EFN SHORTFNfD TO 
sHort^svmbo I 

SEVERITY? Inforffittional 
HEANIHG5 Self explanatory 

2C0C6 UMKMQWN OBJECT TEXT IH file_ntf!i« 
SEVERITY? Error 
HEANINGi Self explanstcry 

20007 UNEXPECTED EOF OR EOR FOUND 
SEVERITY? Error 
HEADING? Self explanatory 

2C008 TOO HANY EXTERN/>L REFERENCES 
SEVERITY? Error 
HEANING? Self explanatory 

20009 HODULE ffio^ule^ngpe IS NOT A HC6800C HOOULt 
SEVERITY? Error 
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HEANINGJ Self txplsniitory 

2C010 OIJI^IICATE ENTRY POINT mm 

StVERITYi Error 

HEANIHGs intry point n^m^ spaelfied mor^ 

than once 

t 

20011 MODULE P0^ula-r>i!!5« IS ALREADY A8S01UTE AND I 

CANNOT 8E REFORMATTED I 

SEVERITYJ Error I 

MEANINGS R€F0R^6aK Is only for relc<;itible I 

modules* I 

« 
t 

2C012 ORG ADDRESS FOR sect f on^nafr^e IS INVALID I 

SEVSRITYJ error 1 

HEANING5 New jsodule Is msde up of too ffltny * 

jiodyles I 

» 

20201 HULTIPL^ IDtMTIFICATION RECORDS FOUND ON J 

HOOULE wodula«nani« I 

SEVERITY? Error ? 

HEAHINGJ Self explanatorY * 

t 

20202 SECTION OF MEW HCOOLE IS TOO LO^G 1 

SEVERITY! Error 1 

HEANINGs New lodule Is made up of toe f^anv J 

podylas ' 

2C2C4 UNKNOWN SECTION ORDINAL FOUND OH HGDULF » 

SEVFRITY5 Error I 

MEANINGS RtcompMs! fpodule * 

2C20S HISSING SECTIOM DEFINITION OH HODULE wcdui e^nBme \ 

SIVERITYi Error S 

'LEANING J Recoup I I e modu I € I 

20206 REFERENCING OUTSIDE SECTIONS ON MODULE fT^odu I e.name ? 
SeVERITYJ Error 1 

HEADINGS Racomplle moduli* * 

202C7 TOO MANY LIBRARIES ENCOUNTERED \ 

SEVERITYJ Error \ 

HEANINGJ Se I f axpl snitor y * 

« 

* 

20211 STARTING PROCEDURE s tar t^or oc.naine NOT IN J 

CODE SECTION 

SEVERITYi Error 

MEANINGS Self explanatory 
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2021? ATTEMPTING TO BIND iiodu I e.nsirt* AN A8SGLUT£ 
NODULE 

SEVERITY! Error 

HEANINGJ siody le^ntPt cannot b# bound* 

20218 COHHOH BLOCK cofflPon..bl ock.name HAS Z DIFFERENT 

LENGTHS* SECOND FOUND IN HOOULE podyft^ntpe 
SEVERITYl Error 

HEANINGS Self «xpl«n0tory 

20219 m^m cMCOONTEREO IN SYH80L TABLf IN HOOULE 

SEVERITY! Error 

HFANIHG! Self explanatory^ recompile niodule, 

2D220 ERROR ENCOUNTEREO IN LINE-TABtt IH HOOULE 
ipody l€^nan?e 

SEVERITY! Error 

HEAHINGi Self 8xpl«nttory* rtcopplle modulft. 

2C3C1 NUHBtR OF IHPUT FILES DOES NOT EOUAL MUH8ER 
OF OUTPUT FILES 
SEVERITY! Error 
HEANING! S«lf «xpl»nftory 

20302 HISSING IDENTIFICATION RECORD ON FILE file name 
SEVERITY! Error 
HEANING! Self txpltinstory 

203G3 FOUND A TEXT RECORD THAT IS HOT SURPORTEO FOR 
HC68000 OH FILE fiU.ntfPt 
SEVERITY! Error 
HEANING! Self explanttory 
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